home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / jet114.zip / JETUSER.DOC < prev    next >
Text File  |  1992-02-25  |  21KB  |  529 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.            ╔═══════════════════════════════════════════════╗
  12.            ║     ██ █████ ██████ ███  ███ ██████ ██ ██     ║
  13.            ║     ██ ██▄▄    ██   ██ ██ ██ ██  ██ ██ ██     ║
  14.            ║     ██ ██▀▀    ██   ██    ██ ██████ ██ ██     ║
  15.            ║ ██████ █████   ██   ██    ██ ██  ██ ██ ██████ ║
  16.            ║  .QWK-Compatible Mail Door for Spitfire 3.x   ║
  17.            ╚═══════════════════════════════════════════════╝
  18.  
  19.                JetMail version 1.00
  20.                User's Guide
  21.                Copyright (c) 1991 by DJ Chuang
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                   Table of Contents
  34.  
  35.  
  36.           Introduction to JetMail . . . . . . . . . . . . . . . . . . .   2
  37.  
  38.           Using JetMail . . . . . . . . . . . . . . . . . . . . . . . .   2
  39.  
  40.           JetMail Main Menu . . . . . . . . . . . . . . . . . . . . . .   3
  41.  
  42.           Selecting Conferences in JetMail  . . . . . . . . . . . . . .   5
  43.  
  44.           JetMail Configuration Setup . . . . . . . . . . . . . . . . .   6
  45.  
  46.           Offline Configuration . . . . . . . . . . . . . . . . . . . .   7
  47.  
  48.           Conclusive Notes  . . . . . . . . . . . . . . . . . . . . . .   8
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           JetMail User's Guide                                       Page 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.           Introduction to JetMail          Introduction to JetMail
  73.  
  74.           JetMail is a .QWK-compatible offline mail door for SPITFIRE,
  75.           copyright by Mike Woltz and Buffalo Creek Software. 
  76.  
  77.           'QWK' is a popular offline mail format introduced by Mark Herring
  78.           for PCBoard.  Its popularity is evident from the number of BBSes
  79.           and 'doors' that now support the QWK mail format and the many QWK
  80.           mail readers.  Offline mail avails to you the opportunity to make
  81.           the most of your online time.  No longer are you confined to
  82.           using only one reader, but you're free to choose a mail reader
  83.           which has a user interface with which you are comfortable.  Some
  84.           readers that may be used with JetMail include:  SLMR, QMail
  85.           Reader, QDeluxe, EZ-Reader, Session Manager, KingQWK, Speed Read,
  86.           Power QWK, WinQWK (for Windows 3.0), AmigaReader (for Amiga
  87.           computers), and MegaMail Reader v2.10. [copyrights and trademarks
  88.           respectively]  MegaMail Reader users must use 2.10 release
  89.           version, not a beta version.
  90.  
  91.  
  92.           Using JetMail          Using JetMail
  93.  
  94.           Two things you need to setup before a .QWK packet can be prepared
  95.           for you to download.  You need to use the "C" command to setup
  96.           your configuration, which specifies your transfer protocol and
  97.           other parameters (a separate help file is available from that
  98.           prompt). Second, you need to use the "S" command to select
  99.           conferences from which you wish to scan for new messages (a
  100.           separate help file is available from that prompt also).
  101.  
  102.           JetMail will facilitate offline mail reading and reply by using
  103.           the QWK format.  The Download command starts JetMail scanning the
  104.           selected conferences for new messages that you have not read. 
  105.           You may also optionally scan for new bulletins and new files
  106.           posted on the BBS. When messages are found, JetMail will prompt
  107.           you - whether you wish to download the messages.  If you answer
  108.           Yes (or Goodbye, which will automatically log you off from the
  109.           board when the transfer is completed), JetMail will prepare the
  110.           .QWK packet for transfer.
  111.  
  112.           When JetMail finishes compressing the files that comprise the
  113.           .QWK packet, JetMail will prompt you with "Ready to transfer". 
  114.           Initiate the 'receive file' on your communication program (i.e.
  115.           Telix, Procomm Plus, GT-Comm, Qmodem), using the transfer
  116.           protocol corresponding to the one you selected in JetMail's
  117.           Configuration Setup. Your computer will receive the .QWK file,
  118.           and your choice mail reader will be able to process the .QWK
  119.           packet to let you read and reply to messages.
  120.  
  121.           When you've replied to messages with your mail reader, there will
  122.           be a .REP file on your hard drive.  Next time you logon this BBS,
  123.           use JetMail's "U" command, for upload a packet.  JetMail will
  124.           prompt you with "Ready to transfer", then you use your
  125.           communication program to send the .REP file.  After the file is
  126.           successfully transferred, JetMail will process the packet and
  127.           post messages into the corresponding conferences.
  128.  
  129.  
  130.           JetMail User's Guide                                       Page 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           JetMail Main Menu          JetMail Main Menu
  140.  
  141.           The Main Menu of JetMail will contain the following commands:
  142.  
  143.           <C>onfiguration setup   
  144.           <S>elect Conferences    
  145.           <D>ownload a Packet     
  146.           <U>pload a Packet     
  147.           <P>ointers upload     
  148.           <G>oodbye (Logoff)
  149.           <Q>uit JetMail door   
  150.           <X> Expert Mode Toggle
  151.           <?> Help
  152.  
  153.           These commands are pretty common to many QWK-compatible mail
  154.           doors, so if you've used other QWK-compatible mail doors, these
  155.           commands should be familiar to you.
  156.  
  157.  
  158.           <C>onfiguration setup
  159.  
  160.                This invokes the JetMail configuration menu.  It allows you
  161.                to select your transfer protocol, compression utility,
  162.                maximum number of messages to scan, and flags for scanning
  163.                bulletins and files.  Read the section entitled JetMail
  164.                Configuration Setup for more details.
  165.  
  166.           <S>elect Conferences
  167.  
  168.                This allows you to select the conferences that you wish to
  169.                scan for messages.  Read the section entitled Selecting
  170.                Conferences in JetMail for more details.
  171.  
  172.           <D>ownload a Packet
  173.  
  174.                Prepares a .QWK mail packet containing new messages scanned
  175.                from the selected conferences.  During the message scan, you
  176.                may hit <SPACE> to abort the mail scan.  A column labeled
  177.                "Flags" shows you the status of the message scan for that
  178.                conference:
  179.  
  180.                     Public    Only Public Messages allowed in conference
  181.                     Net       NetSysop access in conference
  182.                     Yours     Only scan for Your Mail 
  183.                     Yours/NP  Only scan for Your Mail in Public_Only conf.
  184.                     YAll      Scan for mail to you and to all
  185.                     YAll/NP   Scan for mail to you and to all in
  186.                               Public_Only conference
  187.  
  188.                When new messages are found, then you can will be prompted:
  189.  
  190.                   Download packet?  <Y>es, <N>o, or <G>oodbye when done?
  191.  
  192.                Answer YES, and JetMail will compress the message files into
  193.                a QWK packet for you to download using your selected
  194.  
  195.  
  196.           JetMail User's Guide                                       Page 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                transfer protocol.  Answer NO if you don't want to receive
  204.                this packet (if you answer NO, you return to the JetMail
  205.                Main Menu).  Answer GOODBYE for JetMail to logoff
  206.                automatically after the transfer is completed.
  207.  
  208.                You have the option to scan for new bulletins and new files. 
  209.                If you selected to scan for these items in your
  210.                configuration setup, then you will receive new bulletins and
  211.                a list of new files in your QWK also.
  212.  
  213.           <U>pload a Packet
  214.  
  215.                Allows you to upload a .REP packet prepared by your offline
  216.                mail reader.  JetMail will process the packet and post
  217.                messages (your replies) in the corresponding conferences.
  218.  
  219.           <P>ointers upload
  220.  
  221.                With each .QWK you download from JetMail is a pointers file,
  222.                designated with extension .PNT.  This contains the
  223.                conferences' last message read pointers right before you
  224.                downloaded that packet.  You can upload the .PNT file using
  225.                this command to reset the pointers to the way they were
  226.                before you downloaded the .QWK.  What this is used for is in
  227.                case you receive a corrupted Mail Packet, you can upload a
  228.                .PNT file from an older .QWK and reset your pointers for all
  229.                the conferences, much more conveniently than to reset
  230.                pointers for each conference one at a time.
  231.  
  232.           <Q>uit JetMail door
  233.  
  234.                Quit JetMail, and return to SPITFIRE.  If JetMail is being
  235.                run as a door, you will need to re-enter your password to
  236.                return to Spitfire; if JetMail is being run as a sysop
  237.                configured external command from one of the Spitfire main
  238.                menus, you'll return to Spitfire immediately.
  239.  
  240.           <G>oodbye (Logoff)
  241.  
  242.                Invokes automatic logoff from BBS.  JetMail gives you ten
  243.                seconds to abort the logoff.  Hit <ESC> to logoff
  244.                immediately.
  245.  
  246.           <X> Expert Mode Toggle
  247.  
  248.                Toggles on/off the JetMail menu screen.  Once you're
  249.                familiar with the JetMail commands, you can toggle off the
  250.                Main Menu when you open JetMail door to save you time.
  251.  
  252.           <?> Help
  253.  
  254.                Display online help file.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.           JetMail User's Guide                                       Page 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.           Selecting Conferences in JetMail          Selecting Conferences in JetMail
  271.  
  272.           This menu let's you select which conferences you wish to scan for
  273.           new messages to put in your .QWK packet.  It has some unique
  274.           features that differ from other QWK-type doors.
  275.  
  276.           Simply enter the number of the conference you wish to select (or
  277.           deselect) for scanning for new messages.  The sysop has two
  278.           options in conference selection:  he may force certain
  279.           conferences to be selected (perhaps to make sure you receive your
  280.           mail, or to promote a conference).  Forced conferences may not be
  281.           deselected. He may also setup a list of default conference
  282.           selection (perhaps as a suggested list of good conferences in
  283.           which to participate).
  284.  
  285.           There are four 'degrees' of scanning for new messages.  You can
  286.           scan for All new messages, scan for all new messages just
  287.           addressed to you and to All (called "YA", [for Y'all, southern
  288.           accent]), scan for all new messages just addressed to you [called
  289.           Only Yours], and scan for None in a conference [or 'deselect'].
  290.  
  291.           Some 'symbols' used by JetMail in Select Conferences menu:
  292.                !    Forced conference (you must read from this conference)
  293.                *    Scan for all new messages
  294.                %    Scan for messages to YOU and to ALL USERS
  295.                Y    Scan for only new messages addressed to you
  296.                ^    Conference only allows Public Only messages
  297.  
  298.           JetMail messages scan will only pick up public messages, and
  299.           private messages written from you or to you.  You have the option
  300.           of not scanning for messages written by you, which can be toggled
  301.           on/off in the User Configuration Setup ("C" from the main JetMail
  302.           Command prompt). The sysop, and users with sysop security level,
  303.           will receive all private messages.
  304.  
  305.           <S>et All - this selects all conferences.  It will set all
  306.           previously unselected conferences to receive ALL mail, and all
  307.           conferences previously selected for Only Your Mail to "YA" (to
  308.           you and to All) scan.
  309.  
  310.           <R>eset All - resets all previously selected conferences (to
  311.           None).
  312.  
  313.           <C>opy - copies the queue of conferences you selected from the
  314.           Spitfire Message Section into JetMail's selected conferences. 
  315.           This is available if you want to have the same conferences in
  316.           your Spitfire queue as your JetMail selection.
  317.  
  318.           <+> (or PgUp) advance screen to display next 40 conferences.
  319.  
  320.           <-> (or PgDn) scroll screen to display previous 40 conferences.
  321.  
  322.           <Q> returns to the main JetMail Command prompt.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.           JetMail User's Guide                                       Page 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.           JetMail Configuration Setup          JetMail Configuration Setup
  337.  
  338.           The "C" command from the JetMain Main Menu allows you to
  339.           customize the contents of your QWK packet for use with your
  340.           offline mail reader.  A brief explanation of the options
  341.           available are listed below:
  342.  
  343.           <1> Transfer Protocol
  344.  
  345.                You need to select a transfer protocol for JetMail to send a
  346.                .QWK mail packet to you, or for JetMail to receive a .REP
  347.                reply packet from you.  JetMail uses the same transfer
  348.                protocols as those available in Spitfire's external
  349.                protocols list.
  350.  
  351.           <2> Compression Format
  352.  
  353.                Multiple compression utilities may be supported by JetMail. 
  354.                Select the format that you prefer to use with your offline
  355.                mail reader from the list supported by this BBS.
  356.  
  357.           <3> Include Welcome Screen
  358.  
  359.                You can optionally receive the welcome screen from your BBS
  360.                in each mail packet.
  361.  
  362.           <4> Include Goodbye Screen
  363.  
  364.                You can optionally receive the goodbye screen from your BBS.
  365.  
  366.           <5> Include Messages From You
  367.  
  368.                You may skip messages that you wrote by setting this to NO,
  369.                to make your .QWK packet a little smaller.  Besides, you
  370.                probably know what you wrote already, so you can keep
  371.                redundancy down.
  372.  
  373.           <6> Include New Bulletins
  374.  
  375.                JetMail can let you download bulletins updated since the
  376.                last time you used JetMail.  JetMail can scan for all new
  377.                bulletins and put them in your .QWK packet, or scan for
  378.                bulletins updated in the first ten bulletins (in case you
  379.                have games bulletins which are updated daily and you aren't
  380.                interested in).
  381.  
  382.           <7> Include New Files
  383.  
  384.                JetMail can scan for new files in the Files Section and
  385.                include it in your .QWK mail packet.  If you want to scan
  386.                for new files, you can scan all directories or just one
  387.                directory (like the upload directory; this will keep
  388.                scanning time short).
  389.  
  390.           <8> Maximum Number of Messages
  391.  
  392.  
  393.  
  394.           JetMail User's Guide                                       Page 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                This parameter limits the number of messages per .QWK
  402.                packet. You may want to set a limit to make sure your
  403.                offline reader is able to handle the mail packet, or to keep
  404.                a .QWK size is manageable. 
  405.  
  406.           <9> Maximum Messages Per Conference
  407.  
  408.                JetMail by default limits the number of messages per
  409.                conference to 200, because this is a general limitation of
  410.                some offline readers.  However, if you are using a QWK
  411.                reader that is able to process more than 200 messages per
  412.                conference, adjust this parameter appropriately.
  413.  
  414.           <A> Include .NDX Files
  415.  
  416.                Some readers may be able to generate its own index files. 
  417.                You may toggle this flag off to make your .QWK packets a
  418.                little smaller, and JetMail can scan for new messages a
  419.                little faster.
  420.  
  421.           <B> Include User Information
  422.  
  423.                Some .QWK mail readers support a User Statistics screen,
  424.                which contains information of your BBS activities (like how
  425.                many downloads you've made, last login, etc.).  You may
  426.                toggle this option to YES to have JetMail generate this
  427.                information in your .QWK.  Your user information will be
  428.                included in the next (and subsequent) JetMail sessions.
  429.  
  430.  
  431.           Offline Configuration          Offline Configuration
  432.  
  433.           JetMail supports offline configuration, where you can add or
  434.           delete conferences from your offline mail reader.  Some offline
  435.           readers have support for offline configuration, usually from a
  436.           conference listing.  In the conference listing, you can hit "A"
  437.           to add a conference or "D" to drop a conference, which generates
  438.           a message to MARKMAIL or QMAIL or JETMAIL with the subject line
  439.           of ADD, DROP, or RESET.  JetMail does support this type of
  440.           configuration for your convenience.  Some readers that support
  441.           offline configuration of this format include:  SLMR, MarkMail,
  442.           MegaMail Reader 2.10, and EZ-Reader.
  443.  
  444.           However, there is another format for offline configuration
  445.           messages, which is the preferred method for JetMail offline
  446.           configuration.  Simply write a message addressed to JETMAIL and
  447.           enter CONFIG in the Subject field:
  448.  
  449.           ------------------------
  450.                TO: JETMAIL
  451.              FROM: YOUR NAME
  452.           SUBJECT: CONFIG
  453.           ------------------------
  454.  
  455.           Then in the body of the message, enter one of the following
  456.           commands, one per line:
  457.  
  458.  
  459.  
  460.           JetMail User's Guide                                       Page 7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.           ADD conf
  468.                     CONF is the conference number you wish to add to your
  469.                     selected conferences queue.
  470.  
  471.           DROP conf
  472.                     CONF is the conference number you wish to drop from
  473.                     your selected conferences queue.
  474.  
  475.           RESET conf num
  476.                     CONF is the conference number you wish to reset your
  477.                     last message read pointer.  NUM is the message number
  478.                     you wish to reset the conference to.  You may use a
  479.                     negative number for NUM, which JetMail will
  480.                     automatically calculate from the end of the message
  481.                     base: so if NUM is -25, JetMail will place the pointer
  482.                     25 from the high message number of the conference,
  483.                     resulting your receiving the last 25 messages of the
  484.                     conference.
  485.  
  486.           BLTS ON|OFF
  487.                     For BLTS ON, JetMail will scan for new bulletins and
  488.                     put them in the QWK packet.  BLTS OFF turns off new
  489.                     bulletins scan.
  490.  
  491.           FILES ON|OFF
  492.                     For FILES ON, JetMail will scan for new files and put a
  493.                     list of the new files in subsequent QWK packets.  FILES
  494.                     OFF turns off new files scan.
  495.  
  496.           MAXNUMBER number
  497.                     If NUMBER is 0, JetMail will scan for an unlimited
  498.                     number of new messages.  Otherwise, NUMBER specifies
  499.                     the maximum number of messages to include in subsequent
  500.                     QWK packets.
  501.  
  502.  
  503.           Conclusive Notes          Conclusive Notes
  504.  
  505.           This concludes the JetMail User's Guide.  I hope you will enjoy
  506.           using JetMail with Spitfire.  
  507.  
  508.           Many reader programs are shareware, so be sure you try out a
  509.           couple of different ones to find one with which you are most
  510.           comfortable.  Don't settle for second best.  Then again, you
  511.           might have difficulty locating several different readers, or have
  512.           trouble switching between different readers because they're all
  513.           so different, or just don't have the time to experiment.  In that
  514.           case, you can stick with the first QWK reader you find, and that
  515.           is okay too.
  516.  
  517.           Should you have any questions or comments on JetMail, feel free
  518.           to pass them along to me via your Spitfire sysop.  Also, I will
  519.           monitor the Spitfire conferences on RIME and Intelec networks, if
  520.           you would be interested in conversing with me directly.
  521.  
  522.           Thank you for using JetMail!
  523.           DJ Chuang, JetMail author
  524.  
  525.  
  526.           JetMail User's Guide                                       Page 8
  527.  
  528.  
  529.